home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / Development / vbcc / vbcc.readme < prev   
Encoding:
Text File  |  2002-10-27  |  5.4 KB  |  178 lines
  1. Short:    optimizing ISO C compiler (68k/WarpOS/PowerUp/MorphOS)
  2. Uploader: vb@compilers.de (Volker Barthelmann)
  3. Author:   vb@compilers.de (Volker Barthelmann),frank@phoenix.owl.de (Frank Wille)
  4. Type:     dev/c
  5. Version:  0.8
  6. Replaces: dev/c/vbcc_ppc.lha,dev/c/vbccm68k.lha,dev/c/vbccm68ksrc.lha,dev/c/vbccppc.lha,dev/c/vbccppcnative.lha,dev/c/vbccppcsrc.lha,dev/c/vbccsrc.lha,dev/c/vbccwos.lha,dev/c/vbccwosnative.lha,dev/c/vbccwossrc.lha
  7.  
  8.  
  9. vbcc - portable ISO/ANSI C compiler (c) in 1995-2001 by Volker Barthelmann
  10.  
  11.  
  12. INTRODUCTION
  13.  
  14.     vbcc is a portable and retargetable ISO/ANSI C compiler.
  15.  
  16.     This archive contains the compiler, preprocessor, assembler, linker,
  17.     frontend, message browser, startup codes, C-libraries, amiga.lib
  18.     replacements as well as several other tools to generate code for 
  19.     AmigaOS/68k, WarpOS, PowerUp and MorphOS.
  20.  
  21.     Many (but not all) tools in this distribution are provided as
  22.     binaries running on 68k as well as on different PPC systems.
  23.  
  24.     All major parts of this distribution (including compiler,
  25.     preprocessor, libraries etc.) have been built using this system.
  26.  
  27.  
  28. FEATURES
  29.  
  30.     vbcc..
  31.  
  32.     - is portable and retargetable
  33.  
  34.     - comes with a global optimizer that can e.g. do common subexpression
  35.       elimination, constant propagation, function inlining and several
  36.       other optimizations across functions and modules (depending on
  37.       optimization level)
  38.  
  39.     - should be compliant to ANSI/ISO89 and partially ISO99
  40.  
  41.     - can generate code that runs on a plain 68000 CPU
  42.  
  43.     - can generate code optimized for 020/030, 040 or 060
  44.  
  45.     - can generate code that uses the 68881/2, 68040/060 FPUs directly
  46.       and comes with appropriate math-libraries
  47.  
  48.     - can generate code that runs on PowerUp-boards or MorphOS systems
  49.  
  50.     - generates standard Amiga-68k-objects, PPC-ELF-objects or
  51.       WarpOS-EHF-objects
  52.  
  53.     - offers a lot of useful extensions like variable-attributes
  54.       and #pragmas
  55.  
  56.     - comes with a message browser
  57.  
  58.     - offers a lot of error/warning messages that can be turned on/off
  59.       separately
  60.  
  61.  
  62. WHAT'S NEW
  63.  
  64.     Some changes since the last Amiga release:
  65.  
  66.     - bug fixes in the compiler, optimizer, tools and libraries
  67.  
  68.     - improved code-generation
  69.  
  70.     - improved optimizations, including inter-procedural,
  71.       cross-module optimizations and alias-analysis
  72.  
  73.     - support for some c99 features, including
  74.       - long long
  75.       - flexible array members as last element of a struct
  76.       - mixed statements and declarations
  77.       - declarations within for-loops
  78.       - inline function-specifier
  79.       - restrict-qualifier
  80.       - vararg-macros
  81.       - _Pragma
  82.       - increased translation-limits
  83.       - stdint.h
  84.  
  85.     - stack-checking and measurement of stack-usage
  86.  
  87.     - documentation as pdf and html documents
  88.  
  89.     - new attributes (e.g. __amigainterrupt, __section)
  90.  
  91.     - new #pragmas for PPC (amiga-align etc.)
  92.  
  93.     - inline-headers for WarpOS PPC-native libraries
  94.  
  95.     - (backend-specific) predefined macros
  96.  
  97.     - improved libaries and headers
  98.  
  99.     - new versions of Frank Wille's assemblers and linkers
  100.  
  101.     - use of a builtin preprocessor
  102.  
  103.     - support for MorphOS
  104.  
  105.  
  106.  
  107. REQUIREMENTS
  108.  
  109.     To use vbcc you need:
  110.  
  111.     - an Amiga with OS 2.0 or higher
  112.  
  113.     - enough RAM (it is possible to translate small programs with 1MB, but
  114.       for larger programs much more will be needed)
  115.  
  116.     Stuff that is not needed, but may be very useful:
  117.  
  118.     - harddisk
  119.  
  120.     - editor
  121.  
  122.     - make, touch etc.
  123.  
  124.     - the Amiga OS-includes (they can be found on certain CDs)
  125.  
  126.     - pipe-command (to use the message browser)
  127.  
  128.     Also you should know how to use the shell and you should know ANSI C
  129.     (if you need a book I recommend (like everyone) "The C Programming
  130.     Language, Second Edition, ANSI C" by Kernighan and Ritchie).
  131.  
  132.  
  133. LEGAL
  134.  
  135.     Note that this distribution contains several programs, libraries etc.
  136.     that are from different authors and are under different legal status.
  137.     So always read the corresponding documentation to find out under
  138.     what conditions a certain file may be used, distributed etc.
  139.  
  140.     For the most part you can assume that you may use everything for
  141.     non-commercial purposes and may distribute the unchanged archive
  142.     in whole.
  143.  
  144.     Changing any parts from this archive, distributing parts of it or
  145.     using it commercially might be legal for certain parts, but illegal
  146.     for others, so read all docs carefully before doing any of the above.
  147.  
  148.  
  149. DOCUMENTATION
  150.  
  151.     Look for documentation in the doc-subdirectory. First, read
  152.     vbcc.pdf or vbcc.html to learn about the compiler and frontend.
  153.     For the other tools like assemblers and linkers, consider the
  154.     remaining documentation which can be found in this subdirectory.
  155.  
  156.  
  157. BUGREPORTS/COMMENTS
  158.  
  159.     If you think vbcc generates bad code, throws enforcer hits, crashes,
  160.     seems to be not ISO-compliant etc. and the problem is not mentioned
  161.     anywhere in this docs as known problem, please send a mail with your
  162.     system configuration, the vbcc version, the command line you used, the
  163.     source that caused the problem and a brief description of the problem
  164.     to
  165.  
  166.         vb@compilers.de           and/or
  167.         frank@phoenix.owl.de
  168.  
  169.     Also if you find problems with the includes, the libraries or you have
  170.     suggestions, dislikes etc. send us a mail.
  171.     Corrections, improvements etc. of the manuals are appreciated, too.
  172.  
  173.  
  174.  
  175. Volker Barthelmann                                   vb@compilers.de
  176. Frank Wille                                          frank@phoenix.owl.de
  177.  
  178.